Status Flags
The RTK Status bits condense a lot of information into very few bits. This page breaks down the definition of the RTK Status Flag bitfields. This information can be streamed from the 3DM-GQ7 using the RTK Corrections Status (0x93,0x31) message or requested directly from the 3DM-RTK using the Get RTK Device Status Flags (0x0F,0x01) command.
Status Bit Overview
| Bits | Description |
|---|---|
| 0-3 | Modem State |
| 4-7 | Connection Type |
| 8-15 | RSSI |
| 16-19 | Signal Quality |
| 20-23 | Tower Change Indicator |
| 24 | NMEA Timeout Flag |
| 25 | Server Timeout Flag |
| 26 | RTCM Timeout Flag |
| 27 | Device Out of Range Flag |
| 28 | Corrections Unavailable Flag |
| 29-31 | RESERVED |
Modem State
| Integer Value | Description |
|---|---|
| 0 | Off |
| 1 | No Network |
| 2 | Network Connected |
| 3 | Configuring Data Context |
| 4 | Activating Data Context |
| 5 | Configuring Socket |
| 6 | Waiting on Server Handshake |
| 7 | Connected, Idle* |
| 8 | Connected, Streaming* |
* Streaming implies a valid RTCM message has been received in the last 3 seconds, idle reported otherwise
Connection Type
| Integer Value | Description |
|---|---|
| 0 | No Connection |
| 2 | 2G |
| 3 | 3G |
| 4 | 4G |
| 5 | 5G |
RSSI
To convert from the RSSI value in the data packet to real RSSI in dBm, use the following:
Real RSSI = -1.0*bitfield_rssi
Signal Quality Metrics
0-10 indication of signal quality, 0 means unavailable/invalid/not connected, 1 is poor, 10 is excellent.
| Quality | RSSI dBm |
|---|---|
| Excellent | >-69 |
| Good | >-89 |
| Adequate | >-99 |
| Poor/Disconnected | <-99 |
Tower Change Indicator
4-bit value that increments each time a cell tower change occurs. Rolls over from 15 to 0. This is included as a debugging parameter for factory support.
NMEA Timeout Flag
The device has not received a valid NMEA message from the GQ7 in the past 3 seconds. The GQ7 is either not reporting a valid GNSS position or has not been configured to communicate with the RTK Modem. Please check that you have enabled the RTK Modem in the GQ7 settings using the following command: GNSS RTK Dongle Configuration (0x0E,0x10)
Server Timeout Flag
The device has not received any communications with the server in the past 3 seconds.
RTCM Timeout Flag
The device has not received a valid RTCM message from the server in the past 3 seconds.
Device Out of Range Flag
The device's reported position is beyond the server-side configured distance to a base station and will not receive corrections. Please consult your SensorcloudRTK account settings to adjust this distance.
Corrections Unavailable Flag
The server is reporting that corrections are not available given the user's account settings. Please check your SensorcloudRTK account, especially if you are using a 3rd-party NTRIP Server, as the account information may be incorrect or the server is failing to provide corrections.